home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / xprz351.lha / docs / History next >
Text File  |  1995-06-29  |  13KB  |  338 lines
  1.  
  2. 1.0, 29 Jul 89 - Original release.
  3.  
  4. 1.1,  03 Aug 89 - Fixed zsdata() to send file data packet in one swrite()
  5.                   call instead of calling zsendline for every byte, to prevent
  6.                   hammering the serial.device with single-byte write requests
  7.                   during uploads, and to speed up effective data transmission
  8.                   rates.
  9.  
  10. 2.0,  28 Oct 89 - Converted from Manx to Lattice C 5.04.  Created prototypes and
  11.                   made other tweaks as required.  Designed new library skeleton
  12.                   for Lattice code, replacing the old Manx library skeleton.
  13.                   Added new options TC, A, D, K, S, R, and P.  Added support for
  14.                   xpr_options() callback routine, and generally brought things
  15.                   up to par with XPR Spec 2.0.
  16.  
  17. 2.10, 12 Feb 91 - Fixed the following generally minor problems:
  18.  
  19.   o  No longer munges A6 register (this was potentially serious), and added
  20.      callback glue to ensure comm program can't munge OUR registers either.
  21.      Decided that the protective glue was much safer than the more elegant
  22.      direct invocation used in version 2.0.
  23.  
  24.   o  Slightly less transmission overhead (concatenates all output into single
  25.      swrites, builds output packets a bit faster).
  26.  
  27.   o  Considerably less receive overhead; does a lot more waiting and a lot
  28.      fewer sreads, especially at high speed.  WARNING: this change doesn't
  29.      work with VLT version 4.846 or earlier (yes, Willy; it really was
  30.      broken B-)).  This change may or may not actually do you any good,
  31.      depending upon how your comm program implements the xpr_sread() function.
  32.  
  33.   o  Fixed problems getting synchronized with some systems on uploads.
  34.  
  35.   o  No longer closes files twice.
  36.  
  37.   o  Now uses fully-reentrant sprintf() from amiga.lib; no more nasty BSS.
  38.  
  39.   o  A couple of obscure error messages were > 50 bytes long, causing problems
  40.      with some comm program's transfer status windows, e.g. the infamouse VLT
  41.      "Incredible Shrinking Status Window."
  42.  
  43.   o  Stabilized spastic data rate by computing elapsed time more accurately.
  44.  
  45.   o  Fixed sprintf() error which caused invalid filelength to be sent on
  46.      uploads.
  47.  
  48.   o  Aligned all data for optimal performance on 68030++ CPUs (now that I have
  49.      my A3000... B-)).  Doesn't really make any noticeable difference, but it
  50.      makes us 68030 owners feel better anyway.  I'm also including a version of
  51.      the library compiled for the 68020+ CPU, on the same principle.
  52.  
  53.   o  Now uses .DUP2 instead of .DUP.DUP, etc.
  54.  
  55.   o  Added config option E for number of errors which cause an abort.
  56.  
  57.   o  Fixed bogus IO_Torture false alarm concerning timer.device.
  58.  
  59.   o  Tried to fix an elusive Enforcer hit on reading location 0, but I'm not
  60.      sure I really got it, since I had trouble reproducing the problem.
  61.  
  62. 2.50, 15 Nov 91 - Fixed bugs and added the following features:
  63.  
  64.   o  Added code to support 32 bit CRC (Circular Redundancy Check).
  65.      CRC-32 adds a little more protection to the data being sent
  66.      and received than does CRC-16.  Source for the CRC-32 additions
  67.      came from the Unix version of RZ/SZ by Chuck Forsberg.
  68.  
  69.   o  Added code to update_rate() function in utils.c to avoid the
  70.      Guru # 80000005 if you decide to adjust the system clock during an
  71.      upload or download from Daylight Saving Time to Standard Time.  :-)
  72.  
  73.   o  Proto additions using libinit.o and libent.o, and eliminating all
  74.      of the assembler code was supplied by Jim Cooper of SAS.  Jim
  75.      also supplied the mysprintf() code to replace sprintf().  This
  76.      version of XprZmodem can be compiled with the SAS version 5.10 C Compiler.
  77.      I do not know how well it might compile with the Aztec compiler.
  78.  
  79.  
  80.    2.50     update_rate()  fixed fatal error in current-duration
  81.                            calculation.  Caused 80000005 Guru.
  82.  
  83.             sprintf()      replaced with Mysprintf() routine.
  84.                            Thanks to Jim Cooper of the SAS institude
  85.                            for  the libinit and linent objects.
  86.  
  87.             Cyclic Redunduncy Check now uses a 32-bit hard-coded CRC table.
  88.             CRC-32 release by Bill Perkins.
  89.  
  90. --------------------------------------------------------------------------
  91.  
  92. This is basically version 2.50.  I just changed rx_timout from 600 to
  93. 30 in send.c to fix uploads so they truly work.
  94.  
  95. NOTE:  I compiled the 020 version using lattice 5.10b (as well as the
  96.        none '020 version), but since I only have a 68000, I don't know how
  97.        well or if it works.
  98.  
  99.  
  100. John Tillema
  101. jtillema@hacks.arizona.edu
  102.  
  103. ------
  104.  
  105. Recompiled the 2.51 020 version as 2.52 after fixing the LmkFile.020 file.
  106. Internal name of the library was being compiled as XprZmodem.Library.020
  107. rather than as XprZmodem.Library.
  108.  
  109.      Bill Perkins
  110.  
  111. BIX: Wmperkins
  112.  
  113. --------------------------------------------------------------------------
  114.  
  115. 2.51, 29 Jan 92 - Rxtimeout changed from 600 to 300 for upload timeout
  116.                   problem by John Tillema.
  117.  
  118. 2.52, 06 Mar 92 - Recompile code for 68020 library code.  Non-68020 code worked
  119.                   fine but John Tillema was not able to test the 2.51 68020
  120.                   version.
  121.  
  122. ---------------------------------------------------------------------------
  123.  
  124.    2.53 - Special Version by Olaf 'Olsen' Barthel Author from "Term"
  125.           (Don't know what he change)
  126.  
  127. ---------------------------------------------------------------------------
  128.  
  129.   2.60  - Don't know who made this version
  130.   2.60a - Don't know who made this version
  131.  
  132. ---------------------------------------------------------------------------
  133.  
  134. INFO: All Libs up to 2.61 are based on the Source of V2.52!!!
  135. =============================================================
  136.     changes:
  137.  
  138.  2.61 - mysprintf() in Utils.c - returned int changed to unsigned int
  139.     SAS/C get a Warning of this.
  140.  
  141.     - NOT RELEASED! ONLY FOR BETATESTER.
  142.  
  143.     In function XProtocolHostMon() (module Utils.c) declared
  144.     static UBYTE startrcv[] = { ZPAD, ZDLE, ZHEX, "00" };
  145.     SAS/C 6.x get a error of this.
  146.     Declared to:
  147.     static UBYTE *startrcv[] = { ZPAD, ZDLE, ZHEX, '0', '0' };
  148.  
  149.  2.62 - Now Blocksize avaiable
  150.  
  151.     - NOT RELEASED!
  152.  
  153.     Changes by Rainer Hess
  154.  
  155.  2.63 - Now support locale.library to use different languages with
  156.     Workbench 2.1, 3.x. On this time will be only the default
  157.     englisch-language and a german catalog-file. Please send me
  158.     the filled up xprzmodem_catalog.ct for your language.
  159.  
  160.     - NOT RELEASED! ONLY FOR BETATESTER.
  161.  
  162.     Changes by Rainer Hess
  163.  
  164.  2.64 - Aug  3 1993 - Blocksize was global declared, it's now in
  165.     struct Vars.
  166.  
  167.     - NOT RELEASED!
  168.  
  169.     Aug  4 1993 - Bug-Fix in function update_rate(), maschine
  170.     crashes on little files e.g. 2 Bytes - old problem from
  171.     2.52 and before!
  172.  
  173.     Changes by Rainer Hess
  174.  
  175.  3.0  - It's time to make a full release...
  176.  
  177.     Compile Date 13.August.93
  178.  
  179.     Rainer Hess - EMail: rhess@a3tnt.adsp.sub.org
  180.  
  181.  3.1  - Documentation update by Geoffrey Faivre-Malloy
  182.     Conversion of documentation to Amigaguide format.
  183.  
  184.     Code-Changes by Rainer Hess:
  185.     ZModem runs always with the sender blocksize or uses standart-mode
  186.     (M1024) if there is on one system a older zmodem.
  187.  
  188.     Compile Date 03.October.93
  189.  
  190.  3.2 - Added support for FTN operations and FTN Zmodem-derivative protocols
  191.  
  192.     It  seems  that Yves Koingshofer was not given credit for such features
  193.     as  dos.library  usage,  variable  block-size, 8 K blocks etc.  Perhaps
  194.     these  changes  were  done  independantly  to  Yves's xprzedzap.library
  195.     derviative  or  perhaps credit for his work was inadvertandly left out.
  196.     Since  xprzedzap.library received wide release via AmiNet, and has been
  197.     in  use  with  numerous BBS's and Term programs as well as with mailers
  198.     such  as  JAZ,  POP,  RAP, GAZEBO, PORTICUS, UMBRELLA and JAMMAIL for a
  199.     number of years, I found it strange no credit was given to Yves who
  200.     put  so  much  effort  into  this  work. 
  201.     Credit  was  also  not  given  to Russell McOrmond, one of the founding
  202.     members of the XPR list whose format.a was renamed to xprsprintf.a with
  203.     only slight modifications. 
  204.  
  205.     These oversights are rectified here. 
  206.  
  207.     Those few changes of Yves's that did not cross over from xprzedzap.library
  208.     versions  .55,  .85, 1.00 and 1.5 (all based upon xprzmodem 2.52 source)
  209.     or were used without providing a setup option for modification have been
  210.     added here, with some changes of my own to simplify operations when the
  211.     protocol is used in mailers.
  212.  
  213.     Code-Changes by Robert Williamson, in consultation with Yves
  214.     Konigshofer.  Although Yves no longer has an Amiga, he was kind enough
  215.     to  spend many, many hours with me on the phone, discussing the various
  216.     problems  and  solutions  involved  in  producing  these libaraies.  My
  217.     thanks to him are heartfelt.
  218.  
  219.     General:
  220.  
  221.     A number of strings were not localized, corrected.
  222.  
  223.     Only wb2.1+ versions supported
  224.     Removed  all  extra  makefiles  and  replaced  with  a general one using
  225.     macros.
  226.  
  227.     Added  callbacks.a  -  Protection  of ALL registers used for callback
  228.     functions is restored.
  229.     
  230.     XPR 3 xpr_updstatus function is enabled, permitting notification
  231.     of transfer status for EACH file sent or received.
  232.  
  233.     Changed most references to KSIZE as a defined constant to use local
  234.     variable v-Ksize instead.
  235.  
  236.     Compiler DEFINE ZEDZAP causes certain code sections to be replaced with
  237.     xpr-friendly  versions  from  xprzedzap  source  or  new code inserted.
  238.     These  changes  should  be compatible with usage of the library in pure
  239.     Zmodem mode.
  240.  
  241.     Note that set up Defaults are different with xprzedzap.library.
  242.  
  243.     TN       No Text translation
  244.     OR       Overwrite Resume
  245.     B16      Buffer size 16KB 
  246.     F0       Frame size = filelength 
  247.     E30      Error count 30 
  248.     SN       Do not send full directory path  
  249.     RN       Do not use received full directory path  
  250.     AN       Disable Auto-activate mode  
  251.     DN       Do not Delete after sending  
  252.     KY       Keep partial files  
  253.     P""      Comm progrmas provides Path to use for received files  
  254.     M8192    Maximum packet size 8K 
  255.     C0       Set Link BPS Rate  
  256.     NY       Alow Send if there are no files  
  257.     QN       Disable DirectZap escape only CAN  
  258.     ZY       Enable FTN mode  
  259.  
  260.     xprzmodem.library
  261.  
  262.     TC       Comm Program Sets Text translation mode
  263.     ON       Overwrite No
  264.     B16      Buffer size 16 KB
  265.     F0       Frame size = filesize
  266.     E10      Error count 10
  267.     SN       Do not Send full directory path
  268.     RN       Do not use Received full directory path
  269.     AY       Enable Auto-activate mode
  270.     DN       Do not Delete after sending
  271.     KY       Keep partial files  
  272.     P""      Comm program sets Path to use for received files  
  273.     M1024    Set maximum packet size 1K
  274.     C0       Set Link BPS Rate  
  275.     NN       Do not Send if there are no files  
  276.     QN       Disble DirectZap escape only CAN  
  277.     FN       Disable FTN mode  
  278.  
  279.     New Setup options: 
  280.  
  281.     Z   - FTN mode
  282.     The Z option enables FTN operation, when Y, the following is in effect:
  283.         - RxTimeOut is restored to 600ms
  284.         - transfers start with blocksize specified in M option.
  285.         - serialbuffer is cleared before sending/recving.  In FTN
  286.           mode the turnaround from sending to receiveng (and vis-versa)
  287.           is quite fast, clearing the buffer avoids reading echos of our
  288.           own characters or leftovers from the previous transfer.
  289.  
  290.     C<link bps>
  291.     Buffer  size,  and  cps  calculations  will  be based upon link rate if
  292.     passed  with  C<baud> option, otherwise they will be based upon LOCKED
  293.     bps.
  294.  
  295.     N   - send no files mode (DirectZap,  ZedZip  and  ZedZap protocols)
  296.     It is permitted to have a session without sending or receiving files if
  297.     N  option is Y.  This is required with some protocols in FTN mode so as
  298.     not  to  generate a spurious failure after a mailer session.  This also
  299.     chnages EOF mode from sending CAN's to just sending ZFIN.
  300.         
  301.     Q   - DirectZap mode
  302.     Only ZDLE adn ZDLEE will be escaped is Q option is Y (DirectZap protocol)
  303.  
  304.     Changes in status display:
  305.  
  306.     XPR 2.001 support for dual-status windows added.
  307.  
  308.     Protocol name displayed will be one of: 
  309.         Zmodem, 1K blocks standard, up to 8K, non-ftn mode
  310.         ZedZap, up to 8K Blocks based upon bps rate, ftn mode
  311.         ZedZip, 1k blocks , ftn mode
  312.         DirectZap, up to 8k blocks, minimum escaping, ftn mode
  313.  
  314.     Added  localization  for  new  options.   These  are NOT translated for
  315.     german catalog, so that catalog has been removed from distribution.
  316.  
  317.     During  batch  transfers,  Error  message  field is set to "None" when
  318.     starting to send or receive next file.
  319.  
  320.  3.2a (no change in Version number)
  321.     Corrected  DirectZap xfer failure problem
  322.     "Resuming" message was ALWAYS was being printed at start of xfer
  323.     if  (OR)  resume was enabled.  Now only printed if Starting position is
  324.     not 0.
  325.  3.3
  326.     Finished dual-display support, tested with JamMail
  327.  3.4
  328.     Protocol names were not being displayed correctly on receive.
  329.  3.5 
  330.     Added setup option switch to enable/disable XPR2.001 extensions.
  331.     Default is NO for xprzmodem.library and Y for xprzedzap.library.
  332. 3.51
  333.     Fixed  improper variable names in setup which caused unexpected results
  334.     with TERM.
  335.     History removed from Guide file
  336.     Merged xprzedzap.doc into Guide file
  337.     Catalog source now included in BOTH source and user archives
  338.